package pers.xiaojun.boot.module.infra.service.config;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import jakarta.validation.Valid;
import pers.xiaojun.boot.module.infra.controller.config.vo.ConfigQueryReqVO;
import pers.xiaojun.boot.module.infra.controller.config.vo.ConfigSaveReqVO;
import pers.xiaojun.boot.module.infra.dao.entity.ConfigDO;

import java.util.List;

/**
 * 参数配置服务接口
 *
 * @author xiaojun
 * @since 2025-11-09
 */
public interface ConfigService extends IService<ConfigDO> {


    /**
     * 创建参数
     *
     * @param saveVO 新建参数信息
     * @return 参数配置
     */
    ConfigDO saveConfig(ConfigSaveReqVO saveVO);

    /**
     * 更新参数
     *
     * @param updateVO 更新参数信息
     * @return 参数
     */
    ConfigDO updateConfig(ConfigSaveReqVO updateVO);

    /**
     * 根据参数Id删除参数
     *
     * @param configId 参数Id
     */
    void removeConfigById(Long configId);

    /**
     * 根据参数Id删除一批参数
     *
     * @param configIds 参数Id列表
     */
    void removeConfigByIds(List<Long> configIds);

    /**
     * 根据参数Id获取参数信息
     *
     * @param configId 参数Id
     * @return 参数
     */
    ConfigDO getConfigById(Long configId);

    /**
     * 根据参数Key获取参数
     *
     * @param configKey 参数Key
     * @return 参数
     */
    ConfigDO getConfigByKey(String configKey);

    /**
     * 获取参数配置分页
     *
     * @param queryVO 查询参数
     * @return 分页数据
     */
    Page<ConfigDO> listConfigsPage(ConfigQueryReqVO queryVO);


}
